Updates to parameter and requestBody #884
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary of changes:
commaDelimited
tosimple
, reference the type in the RFC and made not applicable toquery
. Described behavior for primitive value, added exploded example.style
based on parameter type.allowEmptyValue
is inapplicable if example table value isn/a
.style
ofx-www-form-urlencoded
toform
, set behavior to be likequery
parameters.contentType
not required, described default values.Note that the behavior of
headeer
andcookie
parameters is different than what we discussed.header
For values
[ red, green, blue ]
:will be
colors: red,green,blue
regardless of whetherexplode
is true/false.This is different than the discussed result of
explode
true represented as:colors: colors=red&colors=green&colors=blue
.cookie
By following
style
beingform
, we get the representation ofSet-Cookie: colors=red,green,blue
by default, so no extra explanation needed (unlike usingsimple
).Open issues:
explode
beingtrue
forcookie
parameter will look like?collectionFormat
by default bemulti
and notcsv
. This means that we should setexplode
totrue
forquery
parameters by default. It's a cumbersome explanation (if this then that, otherwise something else), but doable. Opinions welcome.